home *** CD-ROM | disk | FTP | other *** search
/ Netware Super Library / Netware Super Library.iso / mis_util / tmpdel / readme.swt next >
Text File  |  1994-09-10  |  11KB  |  249 lines
  1.  
  2.                         HOW TO USE SWAT.COM
  3.  
  4.  
  5.         SWAT.COM is a utility to detect and delete temporary
  6.         files.  Temporary files typically have 8 character file
  7.         names that are numeric.  The extensions are typically
  8.         TMP allthough a temporary file can have any extension
  9.         or no extension.
  10.  
  11.         To obtain a license and permanent copy of SWAT.COM, send
  12.         $25 US currency to:
  13.  
  14.                 COMPUTER PRODUCTS implementation
  15.                 6443 Wilkinson Av.
  16.                 North Hollywood,  CA  91606
  17.                 U. S. A.
  18.  
  19.                 Please specify disk format, 3 1/2" or 5 1/4",
  20.                 or for fastest reponse provide your E-mail
  21.                 address.
  22.  
  23.         Why is SWAT needed?  Application programs, such as
  24.         FoxPro, need more memory than is available in any CPU.
  25.         To get this additional memory, the program creates a
  26.         temporary file to hold intermediate results.  When the
  27.         program terminates, the temporary file is deleted.  But
  28.         if the application program terminates abnormally, the
  29.         temporary file may not be deleted.  This temporary file
  30.         is orphaned because the application program will create
  31.         a new temporary file the next time it executes.  Over
  32.         a period of time these orphaned temporary files accum-
  33.         ulate on the hard disk, creating a shortage of available
  34.         disk space for growth.  The accumulation of orphaned
  35.         disk files is also a drag on directory searches, and
  36.         this can slow down the process to open a file.  Since
  37.         orphaned temporary files serve no useful purpose, SWAT
  38.         them out from time to time.  Here are the details:
  39.  
  40.         SWAT.COM has several options which can be activated with
  41.         command line parameters or interactively.  For example:
  42.  
  43.         SWAT -l -i tmp dbf idx . -a -r -p f:\gldist -d 9/28/94
  44.  
  45.         where:
  46.            -l requires SWAT to present each temporary file to
  47.               the user to decide individually which files to
  48.               delete, i.e. to confirm each deletion before it
  49.               occurs.
  50.  
  51.            -i requires SWAT to delete only those temporary
  52.               files with the extensions that follow:
  53.               tmp, dbf, idx and no extension (represented
  54.               by ".")
  55.  
  56.            -a requires SWAT to allow the characters A..F in
  57.               file names in any position but the first.
  58.               (Temporary files created by early versions of
  59.               DOS had ASCII representations of hex digits in
  60.               positions two through eight.)
  61.  
  62.            -r requires SWAT to recursively search subdirectories
  63.               of the requested pathname.
  64.  
  65.            -p presents SWAT with the full pathname (device and
  66.               directory) to search: f:\gldist.
  67.  
  68.            -d requires SWAT to restrict the deletion of temporary
  69.               files to those with file dates earlier than the
  70.               parameter 9/28/94.
  71.  
  72.         The general form of the command line is:
  73.  
  74.         SWAT [-x [prm [prm [prm [...]]]]] [-x [prm [prm [...]]]] ...
  75.  
  76.            where "-x" is an option switch (usually lower case)
  77.            and prm is a related parameter of "-x", depending on
  78.            whether the particular switch requires a parameter
  79.            or parameters.  The switches and their parameters
  80.            can be presented to SWAT in any order.
  81.  
  82.         If no switches/parameters follow SWAT, the user is
  83.         presented with a useage screen and the choice to continue
  84.         by interactively entering switches/parameters.  Note
  85.         that the demo version of SWAT does not support command
  86.         line switches and their parameters.  Users of the demo
  87.         version, however, can interactively command SWAT to do
  88.         anything that can be done with command line parameters.
  89.  
  90.         The full set of switches and parameters currently
  91.         recognized by SWAT are:
  92.  
  93.         -a allow A..F in file names for positions 2..9 of
  94.            filename as well as the default characters of 0..9.
  95.            The first position is always restricted to 0..9.
  96.  
  97.         -B delete only, and all, files with an extension of bak
  98.            (no test made to determine if file is temporary).
  99.            Conditioning for cut-off date, read-only or hidden
  100.            statuses still apply.  This is useful for eliminating
  101.            the accumuation of "bak" files.
  102.  
  103.         -b delete any file with a bak extension in addition to
  104.            temporary files.  Conditioning for cut-off date,
  105.            read-only or hidden statuses still apply.  This is
  106.            useful for eliminating the accumuation of "bak"
  107.            files.
  108.  
  109.         -c <d> curt (short) file names, i.e. file names less
  110.            than 8 characters long.  A one character parameter
  111.            in the range '1' .. '8' is required to specify the
  112.            minimum name length.  For example, the switch and
  113.            parameter -c 5 permit deletion of temporary files
  114.            with 5 to 8 character file names.
  115.  
  116.         -d <mm/dd/yy> cut-off date (system date is default).
  117.            Only files with the same or earlier directory dates
  118.            are eligible for deletion.  Alternatively, a relative
  119.            date can be specified with
  120.  
  121.              -d rd
  122.  
  123.            where r is 'r' or 'R' and d is a number.  swat computes
  124.            the cut-off date as the system date less d days.  If the
  125.            system date is, say, 9/28/94 and the switch and parameter
  126.            are -d R30, then the cut-off date is 30 days prior to
  127.            9/28/94, or 8/29/94.  This is useful to always delete
  128.            temporary files that are, say, 7 days old or older.
  129.  
  130.         -e exclude extensions of prm prm ... prm succeeding
  131.            parameters, maximum of 16 extensions. (Default is no
  132.            exclusions).  Any such entry will override previously
  133.            established inclusions or exclusions, if any.  To
  134.            exclude temporary files with no extension, enter ".".
  135.            Note that switch "-e" will negate any prior switch of
  136.            "-i".  The switches -e and -i are mutually exclusive
  137.            because, logically, the definition of extensions to
  138.            exclude guarantees inclusion of all other extensions.
  139.  
  140.         -h include hidden temporary files as eligible for
  141.            deletion.
  142.  
  143.         -i include extensions of prm prm ... prm succeeding
  144.            parameters, maximum of 16 extensions. (Default is
  145.            include all extensions).  Any such entry will override
  146.            previously established inclusions or exclusions, if
  147.            any.  To include temporary files with no extension,
  148.            enter ".".  Note that switch "-i" will negate any
  149.            prior switch of "-e".  The switches -e and -i are
  150.            mutually exclusive because, logically, the definition
  151.            of extensions to include guarantees exclusion of all
  152.            other extensions.
  153.  
  154.         -l list the file name for the user to confirm deletion
  155.            (default is to delete without asking).
  156.  
  157.         -o include read-only temporary files (default is to exclude
  158.            read-only temporary files).
  159.  
  160.         -p <pathname> The full pathname with device if different
  161.            from currently selected drive and directory (current
  162.            device and directory are default)
  163.  
  164.         -r recursively search all subdirectories for temporary
  165.            files.
  166.  
  167.         -s hour[:minutes[:seconds[P]]] to delay start time to.
  168.            Example: -s 9:55:30P will delay program start until
  169.            9:55:30 P.M. (21:55:30).  (Default is to start
  170.            immediately.)
  171.  
  172.         -v omit view of all switch settings and their parameters
  173.            with an option to proceed or cancel.  If there is no
  174.            -v switch, SWAT will display all switches and their
  175.            parameters and prompt the user for permission to
  176.            continue.  This is very safe and helpful to users who
  177.            need to check the results of their switches and
  178.            parameter settings before proceeding.
  179.  
  180.         In addition to the freedom of entering the switches and
  181.         their parameters in any order, or omitting any of them,
  182.         white space separating a switch from its parameters is
  183.         optional.  That is, the cut-off date can be presented
  184.         as -d 9/28/94 or -d9/28/94.
  185.  
  186.         To facilitate users who wish to run SWAT on a regular
  187.         basis with the same parameters, all parameters, or any
  188.         subset, can be placed in a parameter file and presented
  189.         to SWAT on the command line preceeded immediately with
  190.         the character "@".  That is,
  191.  
  192.            SWAT @params -d 9/28/94
  193.  
  194.         is equivalent to the initial example if the file params
  195.         is:
  196.  
  197.            -l -i tmp dbf idx . -a -r -p f:\gldist
  198.  
  199.         or equivalently:
  200.  
  201.            -l
  202.            -i tmp dbf idx .
  203.            -a
  204.            -r
  205.            -p f:\gldist
  206.  
  207.         That is, in parameter files switches and their parameters
  208.         can be on one line or succeeding lines: SWAT treats
  209.         newline characters as white space.  Note that switches
  210.         and their parameters can be presented on both the command
  211.         line and in one or more parameter files.
  212.  
  213.         For those of a recursive frame of mind, SWAT will
  214.         recognize parameter files within parameter files.
  215.         The above example for the file params could be:
  216.  
  217.            -l -i tmp dbf idx .
  218.            @params2
  219.  
  220.         where the file params2 contains
  221.  
  222.            -a -r -p f:\gldist
  223.  
  224.         With the recursion feature a user can maintain all the
  225.         permanent choices in one file, and vary the others in a
  226.         short file, or enter them separately on the command line
  227.         either before or after the permanent parameter file
  228.         reference.
  229.  
  230.         Good luck in SWATting those pesky orphaned temporary
  231.         files that are clogging your disk drives!
  232.  
  233.         To obtain a license and permanent copy of SWAT.COM, send
  234.         $25 US currency to:
  235.  
  236.                 COMPUTER PRODUCTS implementation
  237.                 6443 Wilkinson Av.
  238.                 North Hollywood,  CA  91606
  239.                 U. S. A.
  240.  
  241.                 Please specify disk format, 3 1/2" or 5 1/4",
  242.                 or for fastest reponse provide your E-mail
  243.                 address for an immediate file upload.
  244.  
  245.  
  246.         COMPUTER PRODUCTS implementation
  247.         September 10, 1994
  248.  
  249.